package com.ruoyi.pack.service;

import java.util.List;
import java.util.Date;
import com.ruoyi.pack.domain.TransportPlan;

/**
 * 运输计划表Service接口
 * 
 * @author wgs
 * @date 2025-08-16
 */
public interface ITransportPlanService 
{
    /**
     * 查询运输计划表
     * 
     * @param id 运输计划表主键
     * @return 运输计划表
     */
    public TransportPlan selectTransportPlanById(Long id);

    /**
     * 查询运输计划表列表
     * 
     * @param transportPlan 运输计划表
     * @return 运输计划表集合
     */
    public List<TransportPlan> selectTransportPlanList(TransportPlan transportPlan);

    /**
     * 新增运输计划表
     * 
     * @param transportPlan 运输计划表
     * @return 结果
     */
    public int insertTransportPlan(TransportPlan transportPlan);

    /**
     * 修改运输计划表
     * 
     * @param transportPlan 运输计划表
     * @return 结果
     */
    public int updateTransportPlan(TransportPlan transportPlan);

    /**
     * 批量删除运输计划表
     * 
     * @param ids 需要删除的运输计划表主键集合
     * @return 结果
     */
    public int deleteTransportPlanByIds(Long[] ids);

    /**
     * 删除运输计划表信息
     * 
     * @param id 运输计划表主键
     * @return 结果
     */
    public int deleteTransportPlanById(Long id);
    
    /**
     * 根据运单ID和城市查询运输计划
     * 
     * @param waybillId 运单ID
     * @param city 城市
     * @return 运输计划
     */
    public TransportPlan selectTransportPlanByWaybillIdAndCity(Long waybillId, String city);

    /**
     * 更新运输计划的到达时间和实际耗时
     * 
     * @param id 运输计划ID
     * @param arrivalTime 到达时间
     * @param actualDuration 实际耗时
     * @return 结果
     */
    public int updateArrivalTimeAndDuration(Long id, Date arrivalTime, Double actualDuration);

    /**
     * 更新运输计划的到达信息（包含偏差数据）
     * 
     * @param id 运输计划ID
     * @param arrivalTime 到达时间
     * @param actualDuration 实际耗时
     * @param arrivalDeviation 到达偏差
     * @param deviationStatus 偏差状态
     * @return 结果
     */
    public int updateArrivalInfoWithDeviation(Long id, Date arrivalTime, Double actualDuration, 
                                             Double arrivalDeviation, String deviationStatus);

    /**
     * 根据运单ID查询起点运输计划
     * 
     * @param waybillId 运单ID
     * @return 运输计划
     */
    public TransportPlan selectStartPointByWaybillId(Long waybillId);

    /**
     * 为运单生成运输计划
     * 
     * @param wayBillId 运单ID
     * @return 结果
     */
    public int generateTransportPlanForWayBill(String wayBillId);
}
